home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / SCSL / sscal.z / sscal
Encoding:
Text File  |  2002-10-03  |  14.6 KB  |  265 lines

  1.  
  2.  
  3.  
  4. SSSSSSSSCCCCAAAALLLL((((3333SSSS))))                                                            SSSSSSSSCCCCAAAALLLL((((3333SSSS))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      SSSSSSSSCCCCAAAALLLL, DDDDSSSSCCCCAAAALLLL, CCCCSSSSSSSSCCCCAAAALLLL, ZZZZDDDDSSSSCCCCAAAALLLL, CCCCSSSSCCCCAAAALLLL, ZZZZSSSSCCCCAAAALLLL - Scales a real or complex
  10.      vector
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      Single precision
  14.  
  15.           Fortran:
  16.                CCCCAAAALLLLLLLL SSSSSSSSCCCCAAAALLLL ((((_n,,,, _a_l_p_h_a,,,, _x,,,, _i_n_c_x))))
  17.  
  18.           C/C++:
  19.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  20.                vvvvooooiiiidddd ssssssssccccaaaallll ((((iiiinnnntttt _n,,,, ffffllllooooaaaatttt _a_l_p_h_a,,,, ffffllllooooaaaatttt *_x,,,, iiiinnnntttt _i_n_c_x))));;;;
  21.  
  22.      Double precision
  23.  
  24.           Fortran:
  25.                CCCCAAAALLLLLLLL DDDDSSSSCCCCAAAALLLL ((((_n,,,, _a_l_p_h_a,,,, _x,,,, _i_n_c_x))))
  26.  
  27.           C/C++:
  28.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  29.                vvvvooooiiiidddd ddddssssccccaaaallll ((((iiiinnnntttt _n,,,, ddddoooouuuubbbblllleeee _a_l_p_h_a,,,, ddddoooouuuubbbblllleeee *_x,,,, iiiinnnntttt _i_n_c_x))));;;;
  30.  
  31.      Single precision complex
  32.  
  33.           Fortran:
  34.                CCCCAAAALLLLLLLL CCCCSSSSSSSSCCCCAAAALLLL ((((_n,,,, _a_l_p_h_a,,,, _x,,,, _i_n_c_x))))
  35.  
  36.                CCCCAAAALLLLLLLL CCCCSSSSCCCCAAAALLLL ((((_n,,,, _a_l_p_h_a,,,, _x,,,, _i_n_c_x))))
  37.  
  38.           C/C++:
  39.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  40.                vvvvooooiiiidddd ccccssssssssccccaaaallll ((((iiiinnnntttt _n,,,, ffffllllooooaaaatttt _a_l_p_h_a,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x))));;;;
  41.  
  42.                vvvvooooiiiidddd ccccssssccccaaaallll ((((iiiinnnntttt _n,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_a_l_p_h_a,,,, ssssccccssssllll____ccccoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt
  43.                _i_n_c_x))));;;;
  44.  
  45.           C++ STL:
  46.                ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>>
  47.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  48.                vvvvooooiiiidddd ccccssssssssccccaaaallll ((((iiiinnnntttt _n,,,, ffffllllooooaaaatttt *_a_l_p_h_a,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_x,,,, iiiinnnntttt _i_n_c_x))));;;;
  49.  
  50.                vvvvooooiiiidddd ccccssssccccaaaallll ((((iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_a_l_p_h_a,,,, ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>> *_x,,,,
  51.                iiiinnnntttt _i_n_c_x))));;;;
  52.  
  53.      Double precision complex
  54.  
  55.           Fortran:
  56.                CCCCAAAALLLLLLLL ZZZZDDDDSSSSCCCCAAAALLLL ((((_n,,,, _a_l_p_h_a,,,, _x,,,, _i_n_c_x))))
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSSSSSCCCCAAAALLLL((((3333SSSS))))                                                            SSSSSSSSCCCCAAAALLLL((((3333SSSS))))
  71.  
  72.  
  73.  
  74.                CCCCAAAALLLLLLLL ZZZZSSSSCCCCAAAALLLL ((((_n,,,, _a_l_p_h_a,,,, _x,,,, _i_n_c_x))))
  75.  
  76.           C/C++:
  77.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  78.                vvvvooooiiiidddd zzzzddddssssccccaaaallll ((((iiiinnnntttt _n,,,, ddddoooouuuubbbblllleeee _a_l_p_h_a,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt _i_n_c_x))));;;;
  79.  
  80.                vvvvooooiiiidddd zzzzssssccccaaaallll ((((iiiinnnntttt _n,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_a_l_p_h_a,,,, ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx *_x,,,, iiiinnnntttt
  81.                _i_n_c_x))));;;;
  82.  
  83.           C++ STL:
  84.                ####iiiinnnncccclllluuuuddddeeee <<<<ccccoooommmmpppplllleeeexxxx....hhhh>>>>
  85.                ####iiiinnnncccclllluuuuddddeeee <<<<ssssccccssssllll____bbbbllllaaaassss....hhhh>>>>
  86.                vvvvooooiiiidddd zzzzddddssssccccaaaallll ((((iiiinnnntttt _n,,,, ddddoooouuuubbbblllleeee *_a_l_p_h_a,,,, ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> *_x,,,, iiiinnnntttt
  87.                _i_n_c_x))));;;;
  88.  
  89.                vvvvooooiiiidddd zzzzssssccccaaaallll ((((iiiinnnntttt _n,,,, ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> *_a_l_p_h_a,,,, ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>> *_x,,,,
  90.                iiiinnnntttt _i_n_c_x))));;;;
  91.  
  92. IIIIMMMMPPPPLLLLEEEEMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
  93.      These routines are part of the SCSL Scientific Library and can be loaded
  94.      using either the ----llllssssccccssss or the ----llllssssccccssss____mmmmpppp option.  The ----llllssssccccssss____mmmmpppp option
  95.      directs the linker to use the multi-processor version of the library.
  96.  
  97.      When linking to SCSL with ----llllssssccccssss or ----llllssssccccssss____mmmmpppp, the default integer size is
  98.      4 bytes (32 bits). Another version of SCSL is available in which integers
  99.      are 8 bytes (64 bits).  This version allows the user access to larger
  100.      memory sizes and helps when porting legacy Cray codes.  It can be loaded
  101.      by using the ----llllssssccccssss____iiii8888 option or the ----llllssssccccssss____iiii8888____mmmmpppp option. A program may use
  102.      only one of the two versions; 4-byte integer and 8-byte integer library
  103.      calls cannot be mixed.
  104.  
  105.      The C and C++ prototypes shown above are appropriate for the 4-byte
  106.      integer version of SCSL. When using the 8-byte integer version, the
  107.      variables of type iiiinnnntttt become lllloooonnnngggg lllloooonnnngggg and the <<<<ssssccccssssllll____bbbbllllaaaassss____iiii8888....hhhh>>>> header
  108.      file should be included.
  109.  
  110. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  111.      SSSSSSSSCCCCAAAALLLL/DDDDSSSSCCCCAAAALLLL scales a real vector with a real scalar.
  112.  
  113.      CCCCSSSSSSSSCCCCAAAALLLL/ZZZZDDDDSSSSCCCCAAAALLLL scales a complex vector with a real scalar.
  114.  
  115.      CCCCSSSSCCCCAAAALLLL/ZZZZSSSSCCCCAAAALLLL scales a complex vector with a complex scalar.
  116.  
  117.      These routines perform the following vector operation:
  118.  
  119.           _x <- _a_l_p_h_a _x
  120.  
  121.      where _a_l_p_h_a is a real or complex scalar, and _x is a real or complex
  122.      vector.
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. SSSSSSSSCCCCAAAALLLL((((3333SSSS))))                                                            SSSSSSSSCCCCAAAALLLL((((3333SSSS))))
  137.  
  138.  
  139.  
  140.      See the NOTES section of this man page for information about the
  141.      interpretation of the data types described in the following arguments.
  142.  
  143.      These routines have the following arguments:
  144.  
  145.      _n         Integer.  (input)
  146.                Number of elements in the vector.  If _n <= 0, these routines
  147.                return without any computation.
  148.  
  149.      _a_l_p_h_a     Scalar alpha. (input)
  150.                SSSSSSSSCCCCAAAALLLL, CCCCSSSSSSSSCCCCAAAALLLL: Single precision.
  151.                DDDDSSSSCCCCAAAALLLL, ZZZZDDDDSSSSCCCCAAAALLLL: Double precision.
  152.                CCCCSSSSCCCCAAAALLLL: Single precision complex.
  153.                ZZZZSSSSCCCCAAAALLLL: Double precision complex.
  154.  
  155.                For C/C++, a pointer to this scalar is passed when alpha is
  156.                complex; otherwise, alpha is passed by value.
  157.  
  158.      _x         Array of dimension (_n-1) * |_i_n_c_x| + 1.  (input and output)
  159.                SSSSSSSSCCCCAAAALLLL: Single precision array.
  160.                DDDDSSSSCCCCAAAALLLL: Double precision array.
  161.                CCCCSSSSSSSSCCCCAAAALLLL, CCCCSSSSCCCCAAAALLLL: Single precision complex array.
  162.                ZZZZDDDDSSSSCCCCAAAALLLL, ZZZZSSSSCCCCAAAALLLL: Double precision complex array.
  163.                Vector to be scaled.
  164.  
  165.      _i_n_c_x      Integer.  (input)
  166.                Increment between elements of _x.  If _i_n_c_x = 0, the results will
  167.                be unpredictable.
  168.  
  169. NNNNOOOOTTTTEEEESSSS
  170.      These routines are Level 1 Basic Linear Algebra Subprograms (Level 1
  171.      BLAS).
  172.  
  173.      When working backward (_i_n_c_x < 0), each routine starts at the end of the
  174.      vector and moves backward, as follows:
  175.  
  176.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)), ..., _x(1)
  177.  
  178.  
  179.    DDDDaaaattttaaaa TTTTyyyyppppeeeessss
  180.      The following data types are described in this documentation:
  181.  
  182.           TTTTeeeerrrrmmmm UUUUsssseeeedddd                     DDDDaaaattttaaaa ttttyyyyppppeeee
  183.  
  184.      Fortran:
  185.  
  186.           Array dimensioned _n           xxxx((((nnnn))))
  187.  
  188.           Integer                       IIIINNNNTTTTEEEEGGGGEEEERRRR (IIIINNNNTTTTEEEEGGGGEEEERRRR****8888 for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. SSSSSSSSCCCCAAAALLLL((((3333SSSS))))                                                            SSSSSSSSCCCCAAAALLLL((((3333SSSS))))
  203.  
  204.  
  205.  
  206.           Single precision              RRRREEEEAAAALLLL
  207.  
  208.           Double precision              DDDDOOOOUUUUBBBBLLLLEEEE PPPPRRRREEEECCCCIIIISSSSIIIIOOOONNNN
  209.  
  210.           Single precision complex      CCCCOOOOMMMMPPPPLLLLEEEEXXXX
  211.  
  212.           Double precision complex      DDDDOOOOUUUUBBBBLLLLEEEE CCCCOOOOMMMMPPPPLLLLEEEEXXXX
  213.  
  214.      C/C++:
  215.  
  216.           Array dimensioned _n           xxxx[[[[_n]]]]
  217.  
  218.           Integer                       iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  219.  
  220.           Single precision              ffffllllooooaaaatttt
  221.  
  222.           Double precision              ddddoooouuuubbbblllleeee
  223.  
  224.           Single precision complex      ssssccccssssllll____ccccoooommmmpppplllleeeexxxx
  225.  
  226.           Double precision complex      ssssccccssssllll____zzzzoooommmmpppplllleeeexxxx
  227.  
  228.      C++ STL:
  229.  
  230.           Array dimensioned _n           xxxx[[[[_n]]]]
  231.  
  232.           Integer                       iiiinnnntttt (lllloooonnnngggg lllloooonnnngggg for ----llllssssccccssss____iiii8888[[[[____mmmmpppp]]]])
  233.  
  234.           Single precision              ffffllllooooaaaatttt
  235.  
  236.           Double precision              ddddoooouuuubbbblllleeee
  237.  
  238.           Single precision complex      ccccoooommmmpppplllleeeexxxx<<<<ffffllllooooaaaatttt>>>>
  239.  
  240.           Double precision complex      ccccoooommmmpppplllleeeexxxx<<<<ddddoooouuuubbbblllleeee>>>>
  241.  
  242. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  243.      IIIINNNNTTTTRRRROOOO____SSSSCCCCSSSSLLLL(3S), IIIINNNNTTTTRRRROOOO____BBBBLLLLAAAASSSS1111(3S)
  244.  
  245.      IIIINNNNTTTTRRRROOOO____CCCCBBBBLLLLAAAASSSS(3S) for information about using the C interface to Fortran 77
  246.      Basic Linear Algebra Subprograms (legacy BLAS) set forth by the Basic
  247.      Linear Algebra Subprograms Technical Forum.
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.                                                                         PPPPaaaaggggeeee 4444
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.